home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / readme9.txt < prev    next >
Text File  |  1995-03-31  |  47KB  |  1,249 lines
  1. DOC 1.1 file -- Goodies Disk #9 root directory file documentation 
  2. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  3. NOTE!  This is a plain ASCII text file containing multiple 
  4. documents. You may find it most convenient to view or print this file 
  5. by running the DOC.EXE program (supplied on this disk) on your PC. 
  6. This is the first Goodies Disk to do it this way.  Hope you like it. 
  7. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  8. :GD9 
  9. :Goodies Disk 9 
  10. :-jkh- 
  11. @@Read Me First! 
  12.              Öíííííííííííííííííííííííííííííí, 
  13.              3 HORN9 disk of HP 48 software 3 
  14.              3        January 4, 1994       3 
  15.              ôíííííííííííííííííííííííííííííí3/4 
  16. Collected & annotated by Joseph K. Horn, also known as 
  17. "-jkh-". 
  18.  
  19. Please read all of this little document before bombarding 
  20. me with questions answered here. Thank you. 
  21.  
  22. This is Joe Horn's personal collection of favorite HP 48 
  23. goodies, disk #9. It contains many excellent programs by 
  24. many excellent programmers. Most of these files were 
  25. downloaded from HP's Corvallis bulletin board system. 
  26.  
  27.                       Öíííííííííííí, 
  28.                       3 DOC & LIST 3 
  29.                       ôíííííííííííí3/4 
  30. This is the first Goodies Disk to use the DOC program for 
  31. viewing and printing the files' documentation.  Just type 
  32. DOC at the DOS prompt on your PC.  See the DOC document 
  33. below for further information about it.  Note: You may 
  34. also use the LIST program (also included here) to view 
  35. and/or print any file on the disk. 
  36.  
  37.                     Öííííííííííííííí, 
  38.                     3 S? SX? G? GX? 3 
  39.                     ôííííííííííííííí3/4 
  40. Whether a program will run on the HP48 S/SX and/or the 
  41. G/GX is indicated in the DOC program's "Select Document" 
  42. column; "SG" means it'll run on the S(X) and G(X); "S-" 
  43. means S(X) only; "-G" means G(X) only.  Notation to this 
  44. effect also appears within each document.  Running a 
  45. program on the wrong machine will almost certainly cause 
  46. a Memory Clear, but will probably not harm the calculator 
  47. hardware.  "PC" means that the program is not for the 
  48. HP48 at all, but is to be run on your IBM PC compatible 
  49. computer.  If that field is blank, then that document is 
  50. not for a program but is purely informational (like the 
  51. document you're reading now). 
  52.  
  53.                     Öíííííííííííííííí, 
  54.                     3 SUBDIRECTORIES 3 
  55.                     ôíííííííííííííííí3/4 
  56. The files are contained in subject-oriented subdirector- 
  57. ies. List FILEINFO.SRC for a complete listing of all the 
  58. files and a brief description of each. 4DOS was used to 
  59. "attach" these descriptions onto every file and subdirec- 
  60. tory on the disk; if you use 4DOS, you will enjoy using 
  61. it with the Goodies Disks.  If you use 4DOS version 5.0 
  62. or above, you'll also see the authors' names. 
  63.  
  64. Éííííííííííííííííííííííííííííííííííííííííííííííííííííííí» 
  65. º Note: Everything on this disk is either freeware or   º 
  66. º shareware. If you use the shareware, please register  º 
  67. º as instructed. PLEASE DO give copies of this disk to  º 
  68. º everybody! (But if you do, please don't change the    º 
  69. º contents.)                                            º 
  70. èííííííííííííííííííííííííííííííííííííííííííííííííííííííí¼ 
  71.  
  72. Files with the same name before the extension are all 
  73. related. For example, FRED would be a downloadable 
  74. binary; FRED.SRC would be its source code (possibly 
  75. commented); etc. To copy a file into the HP 48, you MUST 
  76. specify the entire name; e.g. "FRED.LIB". 
  77.  
  78. I have tried to provide documentation of some sort for 
  79. every file on this disk. If you know who wrote a file "by 
  80. ?", please let me know so that proper credit may be 
  81. given.  Thanx. 
  82.  
  83. Apologies to those whose files I accidentally mangled 
  84. while editing and reformatting for the DOC program. Warm 
  85. thanks to all authors whose works appear here. Good job! 
  86.  
  87. These files are not guaranteed in any way; use at your 
  88. own risk. 
  89.  
  90. For EduCALC Goodies Disk Customer Support, see 
  91. the SUPPORT document below. 
  92.  
  93. - - -  Joseph K. Horn 
  94. Email: akcs.joehorn@hpcvbbs.cv.hp.com 
  95. Snail: 19292 El Toro Road / Silverado, CA 92676-9801 USA 
  96. Phone: None. Pretend I'm deaf. Write. See above. 
  97. @@About GD9 
  98. Poop Sheet about HORN9, the 9th EduCALC HP 48 Goodies 
  99. Disk. 
  100.  
  101.  1. Official Name: "HP 48 Goodies Disk, Vol. 9". 
  102.  
  103.  2. Diskette Volume Label: "HORN9" 
  104.  
  105.  3. Ordering Information from EduCALC: 
  106.  
  107.     Stock #GD9A (5.25-inch high-density mini-floppy), 
  108.     $4.95 
  109.  
  110.     Stock #GD9B (3.5-inch high-density micro-floppy), 
  111.     $4.95 
  112.  
  113.     (Note: This is EduCALC's cost; they make no money off 
  114.     these, nor does anybody else.) 
  115.  
  116.     Shipping: $2.00 parcel post, or $5.00 U.P.S. (USA) 
  117.  
  118.                EduCALC 
  119.                27953 Cabot Road 
  120.                Laguna Niguel, CA 92677 U.S.A. 
  121.  
  122.  4. Copyright: See COPYRIGHTS for details about the 
  123.     files on this disk which HP wrote and copyrighted. 
  124.     The disk as a whole, however, may be freely copied if 
  125.     and only if (1) it is copied in its entirety without 
  126.     any modification to any of its contents whatsoever, 
  127.     and (2) you make no profit in doing so. You may, of 
  128.     course, recoup your copying costs. The idea here is 
  129.     not to make a profit from software which the authors 
  130.     specifically released for non-profit public benefit. 
  131.  
  132.  5. Shareware: Some of these programs are called 
  133.     "shareware" by their authors. This means that they 
  134.     encourage you to "test drive" their programs first, 
  135.     and then if you like them and continue to use them, 
  136.     to send in the suggested "registration fee". Failure 
  137.     to do so will torture your conscience for the rest of 
  138.     your life. 
  139.  
  140.  6. Diskette file recovery: This disk is doubly protected 
  141.     against accidental loss of contents. Several hidden 
  142.     files on the disk allow the full use of MS-DOS 5 & 
  143.     6's UNDELETE and UNFORMAT commands. For those 
  144.     without DOS 5 or 6, Norton's equivalent utilities are 
  145.     also supported (called QU and FR in the early 
  146.     versions, and UNERASE and UNFORMAT in later 
  147.     versions). 
  148.  
  149.  7. Diskette optimization: The contents of this disk are 
  150.     100% unfragmented. Golden Bow Systems' VOPT and 
  151.     Norton's SD (SPEEDISK) were used to optimize the disk 
  152.     for speedy access. Use DISKCOPY to copy it, not 
  153.     XCOPY, to preserve this disk optimization. 
  154.  
  155.  8. Viruses: This diskette was verified as virus-free by 
  156.     Microcom's Virex PC, and as HP-48 virus-free by Brian 
  157.     Maguire's VACCINE.1, and will remain virus-free as 
  158.     long as you keep it write-protected. 
  159.  
  160.  9. Directories: DIR produces alphabetized file listings, 
  161.     even if you don't have 4DOS or DOS 5 or 6, since the 
  162.     directories are sorted using Golden Bow Systems' VDS 
  163.     and Norton's DS. 
  164.  
  165. 10. File Comments: Users of 4DOS or NDOS will notice that 
  166.     every file on this disk has a "description" attached 
  167.     which gets automatically displayed whenever DIR is 
  168.     used. 
  169.  
  170. 11. Documentation: This is the first Goodies Disk to use 
  171.     DOC.EXE for viewing the files' documentation. 
  172. @@Goodies Index 
  173.                          GD9.IDX 
  174.             THE HP48 GOODIES DISKS INDEX FILE 
  175.                        Disks 1 - 9 
  176.               by Stephen J Thomas & Joe Horn 
  177.  
  178. GD9.IDX is an index to all the files included in Joe 
  179. Horn's HP 48 Goodies Disks 1 through 9, except for #4. 
  180. (Disk 4 is HP's System RPL disk, so it is not included in 
  181. this index). 
  182.  
  183. See FETCH on this disk for an easy way to search through 
  184. this index file for key words. FETCH easily answers 
  185. questions like "What file had that reference to Ulam's 
  186. Conjecture, and what disk was it on, and what 
  187. subdirectory was it in?"  Just type 'FETCH Ulam'. Or, 
  188. "What are all the goodies from Bill Wickes?"  Type 'FETCH 
  189. Wickes'. 
  190.  
  191. This index is sorted alphabetically by file name. 
  192. Generally, only one listing is included here WITHOUT file 
  193. name extensions, since files with the same root name are 
  194. related (if they're on the same disk, of course). 
  195.  
  196. The disk number is followed, when necessary, by the first 
  197. two letters of the file's subdirectory. For example, if 
  198. a file is identified as "5PR", that means the file can be 
  199. found on Goodies Disk #5, in the PROGRAMR subdirectory. 
  200.  
  201. Disks #1 and #3 only had one subdirectory (HORN1 and 
  202. HORN3, respectively) containing all the files on those 
  203. disks. The Index File therefore makes no reference to 
  204. the subdirectories on these disks. (They'd all be 1HO 
  205. and 3HO, respectively). 
  206.  
  207. Disk #2 had two subdirectories: 
  208.  
  209.    DNICKEL - Derek Nickel's VOYAGER and related files 
  210.    HORN2 - More random goodies 
  211.  
  212. Therefore the files on Disk 2 are identified with "2DN" 
  213. or "2HO". 
  214.  
  215. Beginning with Disk #5, the files have been organized 
  216. into subdirectories roughly by subject: 
  217.  
  218.    AMIGA - Commodore Amiga Utilities 
  219.    ANIMS - Animated Video Programs (not games) 
  220.    DETLEF - Detlef Mueller's <-LIB-> & <-RPL-> Tools 
  221.    FRANCE - Goodies Received from Paris, France 
  222.    GAMES - Interactive Video Games 
  223.    GROBS - HP 48 Graphic Objects 
  224.    HACKER - Goodies for HP 48 Hackers (SRPL & ML) 
  225.    HP - Goodies From Hewlett Packard Company 
  226.    MATH - Mathematical Utilities 
  227.    POSTINGS - Text-Only Articles from HP's BBS 
  228.    PROGRAMR - Goodies for HP 48 Programmers 
  229.    TUNES - Quaint Melodies & Sound Effects 
  230.    UTILS - Heavy Utilities for HP 48 Power Users 
  231.    WORK - Real-World, Useful, Non-Silly Stuff 
  232.  
  233. Steve Thomas organized this information as an index. The 
  234. actual files listed herein were written by their 
  235. respective authors and collected together by Joe Horn. 
  236. The descriptions and author listing are those Joe 
  237. provided on the Goodies Disks themselves in the FILEINFO 
  238. files. 
  239.  
  240. The Goodies Disks' contents are available from various 
  241. BBSs which support the HP 48, and directly from EduCALC 
  242. on floppies; call 800-677-7001 or 714-582-2637, Mon-Fri 
  243. 8am-5pm, California time. 
  244. @@Support 
  245. CUSTOMER SUPPORT POLICIES FOR EDUCALC PD GOODIES DISK #9 
  246.  
  247. 1.  The EduCALC Goodies Disks have been "successful" 
  248.     beyond my wildest dreams. We've given up trying to 
  249.     keep track of how many copies are out there; it's 
  250.     certainly more than 20,000. This is good news and bad 
  251.     news. It's good because it means that many people 
  252.     appreciate good PD software. The cross-pollenation 
  253.     of ideas will result in even better software. But 
  254.     it's bad because it means that there are thousands of 
  255.     people with thousands of new questions. And they 
  256.     expect me to answer them. 
  257.      
  258.     I can't. I make no money off this project. It's my 
  259.     hobby. If you send me a stamped, self-addressed 
  260.     postcard and make it REAL EASY for me to answer, then 
  261.     I might be tempted to oblige. But if it costs me any 
  262.     money, or isn't fun, forget it. 
  263.  
  264. 2.  The files on this disk are not guaranteed in any way. 
  265.     Use at your own risk. EduCALC copies and sells these 
  266.     disks as a service, not as a product, and does not 
  267.     offer customer support for them in any way. All 
  268.     e-mail to me at the email address below will be 
  269.     answered. Do not ask me how to use these programs; 
  270.     read the .DOC files, and then you'll know more than I 
  271.     do. 
  272.  
  273. Thank you for your HP 48 enthusiasm. Let's keep this PD 
  274. concept going! 
  275.  
  276. - - -  Joseph K. Horn 
  277. Email: akcs.joehorn@hpcvbbs.cv.hp.com 
  278. Snail: 19292 El Toro Road / Silverado, CA 92676-9801 USA 
  279. @@Copyrights 
  280.        úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  281.        3 Notice Of Copyright, Warranty And Rights 3 
  282.        àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  283.  
  284. This software is provided "as is" and is subject to 
  285. change without notice. Neither Hewlett-Packard Company, 
  286. EduCALC Mail Store, Joseph K. Horn, nor the authors of 
  287. other software contained on this disk makes any warranty 
  288. of any kind with regard to this software, including, but 
  289. not limited to, the implied warranties of merchantability 
  290. and fitness for a particular purpose; nor are they liable 
  291. for any errors herein or for incidental or consequential 
  292. damages in connection with the furnishing, performance, 
  293. or use of this software. 
  294.  
  295. Some of the programs on this disk are Copyrighted by 
  296. Hewlett-Packard Company. All rights are reserved. 
  297. Hewlett-Packard Company grants you the right to use any 
  298. Hewlett-Packard copyrighted program contained in this 
  299. product in Hewlett-Packard calculators and to share them 
  300. with others as long as you receive no compensation for 
  301. doing so. If you share these HP copyrighted programs 
  302. with others, you must include this notice with the 
  303. program. HP copyrighted programs contain a copyright 
  304. notice at the beginning of the documentation file. 
  305.  
  306. Some of the programs on this disk are shareware. 
  307. Shareware authors grant you permission to try their 
  308. programs on a limited-time basis. If you like the 
  309. program and intend to keep using it, then you are 
  310. required to send the author a shareware registration fee 
  311. as detailed in the program's documentation. You are also 
  312. granted permission to share the program with others as 
  313. long as you include its full, unmodified documentation, 
  314. and receive no compensation. 
  315.  
  316. Some programs lie between shareware and freeware, and are 
  317. called "giftware". You are free to use and copy these 
  318. programs. The author asks only that you send a token of 
  319. your appreciation. Such authors have written the very 
  320. best software, and I highly encourage you to "make their 
  321. day" by sending them something they'll remember you by. 
  322. Anything from a picture post-card to a title deed of a 
  323. French Riviera chateau would be appreciated. 
  324.  
  325. All other programs and files on this disk are in the 
  326. public domain. Enjoy! 
  327. @@- Root Dir - 
  328. Goodies Disk #9 contains 4 utilities in the root 
  329. directory for use from the DOS prompt: 
  330.  
  331. DOC   : Documentation viewer & printer 
  332. FETCH : Goodies Disk Index Searcher 
  333. SEND  : Easy-to-use Goodies Disk PC-to-HP sender 
  334. GDOK  : Checks file integrity of entire Goodies Disk 
  335.  
  336. BRIK, GREP, and LIST are utilities used by the above. 
  337.  
  338. See the documentation for each of these below. 
  339. @@DOC        PC 
  340. Documentation viewer and printer            version 1.1 
  341. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  342.  
  343. Purpose 
  344. ÄÄÄÄÄÄÄ 
  345. DOC is a simple on-disk documentation viewer to present 
  346. the documents for the programs on this disk. It displays 
  347. a list of available documents down the left side of the 
  348. screen and shows the text of the currently selected 
  349. document on the right. DOC has a simple printing ability 
  350. which will produce a neat printout of a document so that 
  351. you can have a manual at hand while working with a 
  352. program. You can also print to a file, in case you wish 
  353. to create a single document file. 
  354.  
  355. Running DOC 
  356. ÄÄÄÄÄÄÄÄÄÄÄ 
  357. To start DOC, enter the command DOC. If you're looking 
  358. for a particular program's document, you may also give it 
  359. at the command line. For example: 
  360.  
  361.     DOC IceCube 
  362.  
  363. starts DOC and searches for the document for the IceCube 
  364. program. It may take some time to find it, however, since 
  365. it has to search through the entire disk. 
  366.  
  367. You can speed up the search by specifying the document 
  368. file. For example: 
  369.  
  370.     DOC FRANCE IceCube 
  371.  
  372. is very fast because it loads just the FRANCE.TXT 
  373. document file and jumps to the IceCube document in it. 
  374.  
  375. You don't need to type the entire name of the document or 
  376. document file, however; just enough to specify them. For 
  377. example: 
  378.  
  379.     DOC F I 
  380.  
  381. has the same result as the previous example, since there 
  382. is only one document file that starts with "F" and only 
  383. one document in it that starts with "I". 
  384.  
  385. If presented with a list of document files, pick one by 
  386. using the arrow keys or by pressing its first letter, and 
  387. then press ENTER. 
  388.  
  389. Select individual documents within the document file with 
  390. the up and down arrow keys to move through the list on 
  391. the left. Typing the initial letters of a document name 
  392. will jump directly to the next matching document. (Type 
  393. them in quick succession, or DOC will jump to different 
  394. lines with each letter pressed). Once you've found the 
  395. document you want, press TAB, or ENTER (RETURN), or the 
  396. right arrow key to move to the text of the document on 
  397. the right. The cursor keys (Home, End, Up, Down, PgUp, 
  398. PgDn) will now move through the text. Press the left 
  399. arrow or TAB or ENTER key again to go back to select 
  400. other documents. 
  401.  
  402. Press ALT-Q or ESC Q to quit. 
  403.  
  404. The DOC menu 
  405. ÄÄÄÄÄÄÄÄÄÄÄÄ 
  406. To call up DOC's menu, press your favorite menu-launching 
  407. key (ESC, /, Insert, or F10). DOC presents various 
  408. options which you can select with the cursor and ENTER 
  409. keys or by pressing one of the highlighted letters. The 
  410. options will vary depending on your PC's configuration 
  411. and the document files available. 
  412.  
  413. Pressing ESC a second time cancels the menu. 
  414.  
  415. Quitting DOC 
  416. ÄÄÄÄÄÄÄÄÄÄÄÄ 
  417. Choose the Quit option from the menu to leave the DOC 
  418. program and return to DOS. ALT-Q is a shortcut. 
  419.  
  420. Color Display Off 
  421. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  422. Choose Color display off from the menu to ask DOC to work 
  423. in black-and-white. You may wish to do this if you're 
  424. using a laptop with an LCD screen that doesn't show 
  425. colors well or with some greyscale or CGA composite video 
  426. monitors. 
  427.  
  428. If you need to do this, you might also enter the DOS 
  429. command MODE BW80 before running DOC. This makes DOC and 
  430. many other programs start up in black-and-white. Adding 
  431. /M (or just /) to the DOC command at the DOS prompt also 
  432. forces monochrome operation. 
  433.  
  434. This menu option does not appear on PCs that do not have 
  435. color capability. 
  436.  
  437. Extended screen on 
  438. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  439. Choosing this menu option switches the display to 43 or 
  440. 50 lines so that you can see more text without scrolling. 
  441. You can go back to the normal display by choosing 
  442. Extended screen off subsequently. 
  443.  
  444. If you have a Super VGA display card and a program to set 
  445. extended text modes, such as 60 lines deep, you might 
  446. like to try setting an appropriate mode before starting 
  447. DOC. DOC will usually operate with the non-standard 
  448. format. 
  449.  
  450. This menu option is only available on EGA or VGA equipped 
  451. PCs. 
  452.  
  453. Fast screen on 
  454. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  455. This menu option only appears on PCs fitted with CGA 
  456. standard or equivalent displays. Normally the DOC program 
  457. deliberately slows down on this type of display to 
  458. prevent the screen flicker or 'snow' that genuine IBM CGA 
  459. displays (and some compatible makes) can suffer from. If 
  460. your system does not suffer from snow, choose 'Fast 
  461. screen on' for a faster screen display. There's no harm 
  462. in trying this option either way on your PC... snow does 
  463. no harm and you might prefer to have a fast display that 
  464. flickers to a slow one that doesn't. 
  465.  
  466. Print Document 
  467. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  468. Choose this menu option (or use the ALT P shortcut key) 
  469. to print the currently selected document. A menu appears 
  470. from where you can make four print settings, choose Go to 
  471. start printing, or Cancel (or press ESC) to return to 
  472. viewing documents. You may need to alter the settings to 
  473. suit your system before choosing Go as follows: 
  474.  
  475. 1. Output port 
  476.  
  477.    This is the printer interface that DOC should print 
  478.    the document to. By pressing O you can step through 
  479.    the ports fitted to your computer. The default LPT1, 
  480.    the first parallel printer port, is correct for most 
  481.    PCs. DOC can work with a serial printer (COM1 or COM2) 
  482.    if you have one but you must make sure that the port 
  483.    is correctly set up (e.g. with a command such as MODE 
  484.    COM1:9600,n,8,1,p) BEFORE running DOC. X-On/X-Off 
  485.    handshaking is automatically provided for serial 
  486.    printers. 
  487.  
  488.    You can set the output port to "FILE". In this case, 
  489.    DOC will ask for the name of a disk file when you 
  490.    start printing and will then print to disk rather than 
  491.    to a printer. If the file you name already exists, DOC 
  492.    will append pages to it. 
  493.  
  494.    Note that DOC will not print on PostScript printers. 
  495.    If you have one of these, you might like to use the 
  496.    print to FILE option and then use a PostScript 
  497.    conversion program or word processor to print the 
  498.    resulting file. 
  499.  
  500. 2. Lines per page 
  501.  
  502.    This is the number of printable lines on each page on 
  503.    your printer. DOC will print even if this is set 
  504.    incorrectly, but then it will not put the page breaks 
  505.    and headers in the right place. The default is 66 
  506.    lines for standard fan-fold paper. Other common values 
  507.    are 60, 62, 64 and 70. (LaserJet default is 60) 
  508.  
  509.    If you have difficulty with this setting, a workaround 
  510.    is to set the form-length correctly on your printer, 
  511.    enter a small number of lines per page (e.g. 60) and 
  512.    then select the "Use form-feeds" option. 
  513.  
  514. 3. Use form-feeds 
  515.  
  516.    Set this option to Yes if you're using a LaserJet- 
  517.    style printer or any printer with the form-length set 
  518.    correctly. DOC will work with this option set to No by 
  519.    counting output lines, but this is slower. 
  520.  
  521. 4. Pause between pages 
  522.  
  523.    Set this option to Yes if you're feeding single- 
  524.    sheets to the printer... DOC will pause for you to get 
  525.    the next sheet ready between each page. 
  526.  
  527. Working with document files 
  528. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  529. Document files should be kept in the same directory as 
  530. the  DOC.EXE program. Under DOS 3.0 or later, DOC will 
  531. find the files when it starts no matter which drive or 
  532. directory is current (with older versions of DOS, you 
  533. should change to the relevant drive and directory before 
  534. starting DOC). 
  535.  
  536. Multiple document files 
  537. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  538. You can, if you like, place more than one document file 
  539. in the DOC.EXE directory. DOC will display a menu of 
  540. available files when first started and offer a 'Select 
  541. document file' option on its menu to let you switch 
  542. between documents. This menu is automatically skipped if 
  543. there is only one document file. 
  544.  
  545. Document file format 
  546. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 
  547.  
  548. You can use DOC.EXE in your own applications by creating 
  549. your own document files. This can be done with any text 
  550. editor or word processor. 
  551.  
  552. Document files must have filename extensions of TXT, and: 
  553.  
  554. (1) The very first line of the file must begin with: 
  555.  
  556. DOC 1.1 
  557.  
  558. which can be followed by any amount of text, none of 
  559. which will be displayed by DOC, such as the date, author, 
  560. purpose, etc. of the file. 
  561.  
  562. (2) The text following the first colon found (:) is shown 
  563. at the left side of the screen title line, and at the 
  564. beginning of the document selection line for that 
  565. document; the text following the second colon is shown at 
  566. the center of the screen title line, and at the end of 
  567. the document selection line; and the text following the 
  568. third colon is shown at the right side of the title line, 
  569. and nowhere else. 
  570.  
  571. (3) Two consecutive "@" symbols consititutes a manual 
  572. title marker; the following 13 characters will be shown 
  573. in the document title column, and the subsequent lines 
  574. will appear in the text area when that document title is 
  575. selected. 
  576.  
  577. (4) Text lines ought to be kept to a maximum length of 57 
  578. characters, because lines longer than 58 characters will 
  579. be truncated when displayed, forcing the user to scroll 
  580. the screen with the arrow keys. 
  581. @@FETCH      PC 
  582. FETCH, a Goodies Disk Index Hunter, by Joe Horn 
  583. Searches through the Goodies Disk Index for any word(s). 
  584.  
  585. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  586. 3 Mini-instructions: At DOS prompt, type FETCH 3 
  587. 3 and then whatever you want to hunt for.      3 
  588. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  589.  
  590. The search text is not case-sensitive; it doesn't matter 
  591. whether it's in capital letters or lowercase letters. 
  592.  
  593. Uses LIST, either the one on this disk, or the one built 
  594. into 4DOS. 
  595.  
  596. FETCH is great for answering questions like "What Disk is 
  597. HYDE.LIB on?" or "Is there anything on the Goodies Disks 
  598. about Ulam's Conjecture?" FETCH HYDE and FETCH ULAM is 
  599. all it takes! 
  600.  
  601. As written, FETCH assumes that the index file is called 
  602. GD9.IDX and is in the current directory. It would be 
  603. better to move the index file and FETCH onto your hard 
  604. disk (in a subdirectory in your PATH), and to edit FETCH 
  605. to reflect the location of the index file. That way, you 
  606. can FETCH things any time, no matter what directory you 
  607. happen to be in; and it runs MUCH faster. 
  608.  
  609. Suggestions for improvements to FETCH (especially if you 
  610. also tell me how to implement your suggestions!) are 
  611. requested: 
  612.  
  613.     Joseph K. Horn 
  614.     19292 EL TORO ROAD 
  615.     SILVERADO, CA 92676-9801 
  616. @@SEND       PC 
  617. SEND, a handy-dandy auto-kermit utility for 4DOS users. 
  618.  
  619. By Joseph Horn (a True Believer in 4DOS). 
  620.  
  621. This little program needs 4DOS to work correctly. 
  622. *AND SO DO YOU* 
  623.  
  624. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  625. 3 MINI-INSTRUCTIONS: Point and shoot at the desired   3 
  626. 3 directory, then at the desired file, and it will be 3 
  627. 3 sent to the HP48 in SERVER mode.                    3 
  628. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  629.  
  630. 4DOS users can send any HP48 file from this disk to their 
  631. calculators easily: type SEND and then "point and shoot". 
  632. It's not as versatile as Norton Commander, but it's less 
  633. expensive! 
  634.  
  635. (NOTE: It is assumed that you have KERMIT.EXE renamed as 
  636. K.EXE on your hard disk and in your system path. If you 
  637. call it KERMIT.EXE, change the "k" in SEND.BTM to 
  638. "kermit" and then SEND will work just fine. Or do what I 
  639. did: include k*ermit=kermit.exe in your alias file.) 
  640.  
  641. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  642. 3 FULL INSTRUCTIONS: 3 
  643. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  644.  
  645. First, put your HP 48 in SERVER mode (S/SX: press 
  646. blue-shift PRG; G/GX: press green-shift SWAP). 
  647.  
  648. Type SEND on your PC. A menu of the disk's 
  649. subdirectories will be displayed. Use the arrow keys to 
  650. highlight the desired subdirectory, and press ENTER to 
  651. select it. 
  652.  
  653. Then a menu of that subdirectory's downloadable files 
  654. will be displayed, complete with a brief description of 
  655. each. Use the arrow keys to highlight the desired file, 
  656. and press ENTER to send the file to the HP48. (Note: 
  657. Pressing the space bar instead of ENTER allows you to 
  658. mark multiple files, which are then sent in a batch when 
  659. you press ENTER). 
  660.  
  661. When transmission is complete, the HP48 will exit server 
  662. mode automatically. 
  663.  
  664. If you decide to abort SEND by pressing ESC on your PC, 
  665. you may have to also press E on your PC to exit kermit. 
  666.  
  667. Note: SEND is ObviousWare, no rights reserved. 
  668.  
  669. -jkh- 
  670. @@GDOK       PC 
  671. GDOK (Goodies Disk Okay?) File Integrity Verifier 
  672.  
  673. Uses BRIK.EXE; make sure it is in your PATH. 
  674.  
  675. Instructions: Just type GDOK at the DOS prompt, and wait 
  676. a few minutes. A list of all the files which are not 
  677. identical to the original Goodies Disk files will be 
  678. displayed.  If none are displayed, all are okay. 
  679.  
  680. GDOK runs a lot faster on a hard disk, and if it finds 
  681. any bad files, you can recover by copying the files from 
  682. the original Goodies Disk onto your hard drive. If you 
  683. run GDOK directly from the floppy, and it finds bad 
  684. files, you're out of luck. 
  685.  
  686. GDOK was originally written to prevent pranksters at my 
  687. school from altering the Goodies Disks' contents on the 
  688. IBM's in the computer lab. GDOK was included here at the 
  689. request of several other educators, but can be useful to 
  690. anybody who suspects that a file got mangled somehow. 
  691.  
  692. -jkh- 
  693. @@GREP       PC 
  694. GREP: A UNIX-like text-search utility; better than "FIND" 
  695. in MS-DOS. 
  696.  
  697. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  698. 3 Mini-instructions: Type "GREP ?" at the 3 
  699. 3 DOS prompt for the grep help screen.    3 
  700. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  701.  
  702. Used by the Goodies Disk FETCH batch file. I suggest 
  703. putting it in your DOS directory and using grep instead 
  704. of DOS's "FIND" command. 
  705.  
  706. Complete documentation for GREP.COM can be found on 
  707. Goodies Disk #8. 
  708. @@BRIK       PC 
  709.                         Brik  1.0 
  710.                   A free CRC-32 program 
  711.                             by 
  712.                        Rahul Dhesi 
  713.  
  714. [Note: BRIK is used by GDOK.BAT; I suggest that you copy 
  715. BRIK.EXE to your C:\DOS directory, or any directory 
  716. that's in your PATH. -jkh-] 
  717.  
  718. Brik 1.0 generates and verifies 32-bit CRC values 
  719. (checksums). It is designed to generate CRCs for text 
  720. files that are the same on all computer systems that use 
  721. the ASCII character set, provided each text file is in 
  722. the usual text file format for each system. Brik 1.0 
  723. will also optionally use binary CRCs calculated using 
  724. every byte in a file. Such binary CRCs are portable 
  725. across systems for binary files that are moved from 
  726. system to system without any newline conversion. 
  727.  
  728. The general usage format is: 
  729.  
  730.      brik -gcGCbfvsWT [file] ... 
  731.  
  732. The brackets mean that "file", which is the name of a 
  733. file, is optional. The three dots indicate that more 
  734. than one filenames may be typed (separated by blanks). 
  735. Exactly one of the options -c, -C, -g, -G, or -h is 
  736. required. The -h option gives a help screen. 
  737.  
  738. In addition to -h, the brik options available (as they 
  739. appear on the help screen) are: 
  740.  
  741.   -g   look for Checksum: header, generate CRC for rest 
  742.           of file 
  743.  
  744.   -c   get CRC from header, verify CRC of rest of file 
  745.  
  746.   -G   generate CRC for entire file (add -b for binary 
  747.           files) 
  748.  
  749.   -C   verify all file CRCs from output of -G (-f is not 
  750.           needed) 
  751.  
  752.   -b   use binary mode--read file byte by byte, not line 
  753.           by line 
  754.  
  755.   -f   read filenames (wildcards ok) from specified files 
  756.  
  757.   -v   be verbose, report all results (else only errors 
  758.           are reported) 
  759.  
  760.   -s   be silent, say nothing, just return status code 
  761.  
  762.   -W   after generating CRC with -g, write it to original 
  763.           header 
  764.  
  765.   -T   include trailing empty lines, normally ignored 
  766.           (text mode only) 
  767.  
  768. VERIFYING CRC HEADERS 
  769.  
  770. The primary intended use of brik is to verify Checksum: 
  771. headers in Usenet postings and in C and Pascal source 
  772. files. A Checksum: header looks like this: 
  773.  
  774.   Checksum: 9485762645   (verify or update this with 
  775.      "brik") 
  776.  
  777. The word "Checksum:" must occur at the beginning of a 
  778. line. It is followed by a colon, an optional blank, a 
  779. ten-digit CRC-32 value, and any arbitrary optional string 
  780. such as the comment shown above. When brik is invoked 
  781. with the syntax 
  782.  
  783.   brik -c file ... 
  784.  
  785. it will search for the Checksum: header in each specified 
  786. file, read the CRC value from that header, calculate the 
  787. CRC-32 for all lines in the file that occur *after* the 
  788. header line, and report an error if the two values do not 
  789. match. Brik ignores any trailing empty lines. 
  790.  
  791.  
  792. CALCULATING CRC HEADERS 
  793.  
  794. The command 
  795.  
  796.   brik -g file ... 
  797.  
  798. tells brik to look for the Checksum: header in each 
  799. specified file, calculate the CRC of the lines in the 
  800. file following the header, and print the CRC and filename 
  801. without changing the file in any way. You can also ask 
  802. brik to update the Checksum: header with the following 
  803. command: 
  804.  
  805.   brik -gW file ... 
  806.  
  807. This causes brik to fill in the newly-calculated CRC in 
  808. the Checksum: header. If there is not enough space for 
  809. the CRC value in the existing header, brik reports an 
  810. error and does not change the existing header. To 
  811. initially add a Checksum: header to a file, insert a line 
  812. of the following form into the file with a text editor: 
  813.  
  814.   Checksum: XXXXXXXXXX  -- this is an optional comment 
  815.  
  816. The word "Checksum" must be at the beginning of a line. 
  817. The ten 'X' characters shown can be any ten characters. 
  818. They will be later replaced by the calculated CRC value. 
  819. They do not need to be 'X'. The comment following them 
  820. is optional and can be any arbitrary string of characters 
  821. after the CRC field, separated from it by a blank. As an 
  822. example, in a C source file called "main.c", you might 
  823. have: 
  824.  
  825.   /* 
  826.   Checksum: XXXXXXXXXX (verify or update this with brik) 
  827.   */ 
  828.  
  829. Once a header like this exists in the file, invoke brik 
  830. as follows: 
  831.  
  832.   brik -gW main.c 
  833.  
  834. This will cause the ten 'X' characters to be replaced 
  835. with the calculated checksum, giving something like this: 
  836.  
  837.   /* 
  838.   Checksum: 1922837484 (verify or update this with brik) 
  839.   */ 
  840.  
  841. Later you can use the command 
  842.  
  843.      brik -c main.c 
  844.  
  845. to verify that the contents of the file following the 
  846. header have the same CRC as the stored value. 
  847.  
  848. If brik is invoked with the -c or -g options and it 
  849. cannot find a Checksum: header in a file, it prints a row 
  850. of question marks. If it is invoked with the -gW option 
  851. and it does not find enough character positions after the 
  852. "Checksum:" string to hold the CRC, it does not fill in 
  853. the CRC and prints an error message. 
  854.  
  855. When calculating the CRC to fill in with the -gW option, 
  856. brik ignores any trailing empty lines in the file. 
  857.  
  858.  
  859. WHOLE-FILE CRCS 
  860.  
  861. A "whole-file" CRC calculation is done for the entire 
  862. contents of a file, without looking for a Checksum: 
  863. header. The command 
  864.  
  865.      brik -G file ... 
  866.  
  867. asks brik to do this calculation for all specified files. 
  868. The output from this command is a list of files and their 
  869. whole-file CRCs. It is sent to the standard output 
  870. stream, which in most cases is your screen. The output 
  871. should be saved in a file by redirecting it. For 
  872. example, the command "brik -G *.h *.c > crc.lst" on an 
  873. MS-DOS system might yield the following in the output 
  874. file "crc.lst": 
  875.  
  876.   # Whole file CRCs generated by Brik v1.0. 
  877.   # Use "brik -C" to verify them. 
  878.  
  879.   # CRC-32        filename 
  880.   # ------        -------- 
  881.  
  882.   2566277976      getopt.c 
  883.    100594287      brik.c 
  884.   1151475469      vms.c 
  885.   3929503738      turboc.c 
  886.   2424271922      addbfcrc.c 
  887.   1943472856      assert.h 
  888.   2601923477      brik.h 
  889.  
  890. The output of the -G option is in free format. The 
  891. output file may be edited by hand. Empty lines and lines 
  892. beginning with '#' will be ignored by brik when it is 
  893. later asked to read this file. 
  894.  
  895. This list of filenames and whole-file CRCs may be 
  896. verified by a command like this: 
  897.  
  898.   brik -C crc.lst 
  899.  
  900. This makes brik read the file "crc.lst", get the CRCs and 
  901. filenames from it, do the CRC calculation again for each 
  902. file, and report an error if it does not match the CRC 
  903. recorded inside "crc.lst". 
  904.  
  905. UNIX and MS-DOS users (and others who can pipe the output 
  906. of one command into another) could use a command like the 
  907. following to see if brik's -G and -C options are working: 
  908.  
  909.      brik -G file ... | brik -C 
  910.  
  911. This invokes "brik -G" on some files, sending the output 
  912. to a pipe where it becomes the input of "brik -C". If no 
  913. filename is specified, brik reads from standard input, so 
  914. "brik -C" will read from the pipe and concurrently verify 
  915. all the CRCs that are being generated by "brik -G". 
  916.  
  917. Whole-file CRCs are normally generated in text mode, in 
  918. which a file is treated as lines of text. In this mode 
  919. brik ignores any trailing empty lines in a file. You can 
  920. also generate whole-file CRCs in binary mode. See below. 
  921.  
  922.  
  923. BINARY VERSUS TEXT MODE  
  924.  
  925. Brik can work in two different modes. The most common 
  926. mode, used by the -g, -c, and -G options, is text mode. 
  927. In this mode brik ignores all trailing empty lines in 
  928. files. (See more about this below.) 
  929.  
  930. In text mode, brik reads all files line by line, and 
  931. forces lines to be terminated by a newline character of 
  932. constant value before doing a CRC calculation. Thus, no 
  933. matter what newline character is used by your system, the 
  934. CRC calculation will be unaffected. This means that 
  935. whether your operating system uses linefeeds to terminate 
  936. lines (e.g. UNIX), or a carriage return and a linefeed 
  937. (e.g. MS-DOS) or a carriage return only (e.g. Macintosh) 
  938. or nothing but a record length field (e.g. VAX/VMS), the 
  939. CRC calculation in text mode gives the same results. 
  940.  
  941. If a file is not intended to be a text file, the text 
  942. mode CRC calculated by brik may not be reliable or the 
  943. same on all systems for the same file. Brik can be asked 
  944. to operate in binary mode by adding a -b option to the 
  945. option. Binary mode is applicable only to the -G option, 
  946. which acts on whole files. Thus while "brik -G file..." 
  947. finds whole-file CRCs of all specified files in text 
  948. mode, "brik -Gb file ..." does the same in binary mode. 
  949. In binary mode brik attempts no newline compensation, but 
  950. simply reads and calculates the CRC for all bytes in a 
  951. file. Provided a file is moved from one system to 
  952. another without any changes, brik should calculate the 
  953. same CRC for it on both systems. 
  954.  
  955. The output from "brik -Gb" includes a trailing 'b' 
  956. character in each CRC, so "brik -C" will correctly use 
  957. text or binary mode as needed, and -Cb is equivalent to 
  958. just -C. 
  959.  
  960.  
  961. TRAILING EMPTY LINES 
  962.  
  963. The normal behavior of brik in text mode is to ignore any 
  964. trailing empty lines in a file when checking or updating 
  965. the CRC in a Checksum: header. An empty line is a line 
  966. that contains nothing, not even blanks or tabs. (Just 
  967. hitting a carriage return when you are editing a text 
  968. file usually produces an empty line.)   If manipulating a 
  969. text file causes trailing empty lines to be added or 
  970. deleted, the CRC calculated by brik will be unaffected. 
  971.  
  972. You can override this if necessary with the -T option, 
  973. which makes brik include trailing empty lines in the CRC 
  974. calculation. For example, "brik -gWT" will update the 
  975. Checksum: header with a CRC value that includes all lines 
  976. in a text file. Similarly "brik -GT" will find 
  977. whole-file CRCs that include all lines in a text file. 
  978.  
  979. When brik is given the -T option, it adds a 'T' suffix to 
  980. each generated CRC value. Then, when the CRC is verified 
  981. with "brik -c" or "brik -C", brik will correctly include 
  982. trailing empty lines without having to be explicitly told 
  983. to do so. 
  984.  
  985. In binary mode brik always reads all bytes in a file, so 
  986. it does not ignore trailing empty lines, and the -T 
  987. switch is not needed. 
  988.  
  989. The -T and -b options are mutually exclusive, since the 
  990. first is used only for text mode and the second is used 
  991. only for binary mode. If both are given, whichever is 
  992. used later overrides the first. This "-bT" is equivalent 
  993. to "-T" and "-Tb" is equivalent to "-T". 
  994.  
  995.  
  996. FILENAME CONVENTIONS 
  997.  
  998. Under MS-DOS and VAX/VMS, wildcards are allowed on the 
  999. command line and will be expanded by brik. Under UNIX, 
  1000. wildcards are expected to be expanded by the shell and 
  1001. are not expanded by brik. 
  1002.  
  1003. If no filename is given, brik reads its standard input. 
  1004. By default this is keyboard input, but it is expected 
  1005. that input will usually be redirected to come from a file 
  1006. or a pipe. Also, if a filename is explicitly specified 
  1007. as a dash ("-"), it stands for standard input. 
  1008.  
  1009. Thus the following five commands (valid under the UNIX 
  1010. operating system) 
  1011.  
  1012.   brik -c myfile 
  1013.   # verify "myfile" 
  1014.  
  1015.   brik -c < myfile 
  1016.   # verify stdin, which is "myfile" 
  1017.  
  1018.   cat myfile | brik -c 
  1019.   # verify stdin, which is a pipe 
  1020.  
  1021.   brik -c - < myfile 
  1022.   # verify "-", which is stdin, which is "myfile" 
  1023.  
  1024.   cat myfile | brik -c - 
  1025.   # verify "-", which is stdin, which is a pipe 
  1026.  
  1027. all have the effect of verifying the Checksum: header in 
  1028. the file "myfile". 
  1029.  
  1030. Standard input can also be read by "brik -C". For 
  1031. example, suppose we have already given the command 
  1032.  
  1033.   brik -G *.c *.h > crc.lst 
  1034.  
  1035. to create a file called "crc.lst" that contains a list of 
  1036. whole-file CRCs. We can now verify the integrity of 
  1037. these files with any of the following commands: 
  1038.  
  1039.   brik -C crc.lst 
  1040.   # read "crc.lst" 
  1041.  
  1042.   brik -C < crc.lst 
  1043.   # read stdin, which is "crc.lst" 
  1044.  
  1045.   brik -C - < crc.lst 
  1046.   # read "-", which is stdin, which is "crc.lst" 
  1047.  
  1048.   cat crc.lst | brik -C 
  1049.   # read stdin, which is a pipe 
  1050.  
  1051.   cat crc.lst | brik -C - 
  1052.   # read "-" which is stdin which is a pipe 
  1053.  
  1054.  
  1055. INDIRECT FILE NAMING 
  1056.  
  1057. The -f option allows you to have filenames in a list 
  1058. rather than on the command line. For example, suppose 
  1059. you want to generate whole-file CRCs of files whose names 
  1060. are selected by some other program. You could use "find" 
  1061. (under UNIX) or "stuff" (under MS-DOS) to generate a list 
  1062. of filenames. When the -f option is given, brik reads 
  1063. filenames, one per line, from the file(s) specified. 
  1064. Thus you could do the following: 
  1065.  
  1066.   find . -mtime +3 -print > flist 
  1067.   brik -Gf flist > crc.lst 
  1068.  
  1069. The first command asks "find" to generate a list of names 
  1070. of all files that were modified more than 3 days ago, and 
  1071. sends the output to the file "flist". The contents of 
  1072. "flist" might now look like this, as an example: 
  1073.  
  1074.   ./sez.doc 
  1075.   ./brik.doc 
  1076.   ./stuff.doc 
  1077.   ./looz.doc 
  1078.   ./fiz.man 
  1079.  
  1080. The second command above asks brik to read the file 
  1081. called "flist", get a list of filenames from it, one per 
  1082. line, and generate the whole-file CRC of each of these 
  1083. files. We additionally redirect the output of "brik -Gf" 
  1084. to the file called "crc.lst". Given the above contents 
  1085. of "flist", the following two commands are exactly 
  1086. equivalent: 
  1087.  
  1088.   brik -Gf flist > crc.lst 
  1089.  
  1090.   brik -G ./sez.doc ./brik.doc ./stuff.doc ./looz.doc 
  1091.        ./fiz.man > crc.lst 
  1092.  
  1093. The advantage of the -f option is that once you have 
  1094. filenames in a file, you need not type them again at the 
  1095. command line. The -f option also allows you to feed brik 
  1096. filenames generated by another program through a pipe. 
  1097. Consider this command: 
  1098.  
  1099.   find . -mtime +3 -print | brik -Gf - > crc.lst 
  1100.  
  1101. Under UNIX this concurrently invokes both "find" and 
  1102. brik. As find generates a filename and sends it to its 
  1103. standard output (a pipe), brik reads the filename from 
  1104. its standard input and generates its whole-file CRC. The 
  1105. following pipeline 
  1106.  
  1107.   find . -mtime +3 -print | brik -Gf - | brik -C - 
  1108.  
  1109. invokes "find" to generate filenames, brik to print the 
  1110. whole-file CRCs of those files, and brik again to 
  1111. immediately verify them. 
  1112.  
  1113. Under MS-DOS and VAX/VMS (and any other operating system 
  1114. under which brik has been installed to expand wildcards 
  1115. itself), a file specified by the -f option can itself 
  1116. contain wildcards in the filenames. For example, suppose 
  1117. the file "wildfile" contains the following lines: 
  1118.  
  1119.   /bin/*.exe 
  1120.   /bin/*.com 
  1121.   /doc/*.doc 
  1122.  
  1123. Now if we invoke brik with the command 
  1124.  
  1125.   brik -Gf wildfile 
  1126.  
  1127. it will read filespecs from "wildfile", expand wildcards 
  1128. in each filespec, and generate whole-file CRCs for all 
  1129. matching files. 
  1130.  
  1131. If you are checking whole-file CRCs with the -C option, 
  1132. you do *not* normally need to use the -f option, as the 
  1133. -f option introduces an additional level of file naming 
  1134. indirection. For example, the command 
  1135.  
  1136.   brik -C crc.lst 
  1137.  
  1138. takes a list of CRCs and filenames from "crc.lst" and 
  1139. verifies them. However, the command 
  1140.  
  1141.   brik -Cf master.lst 
  1142.  
  1143. does not do the same thing. Instead, it takes a list of 
  1144. files from "master.lst", looks inside each of *those* 
  1145. files for a list of CRCs and filenames, and verifies 
  1146. them. 
  1147.  
  1148. As an example of the use of -Cf, consider this sequence: 
  1149.  
  1150.   brik -Gb /bin/*.exe > exelist 
  1151.   brik -Gb /bin/*.com > comlist 
  1152.   brik -GT /doc/*.doc > doclist 
  1153.   brik -G  /doc/*.man > manlist 
  1154.  
  1155. Now we have four files called "exelist", "comlist", 
  1156. "doclist", and "manlist" containing whole-file CRCs of 
  1157. various types. We can test the integrity of files listed 
  1158. in these in four separate commands like this: 
  1159.  
  1160.   brik -C exelist 
  1161.   brik -C comlist 
  1162.   brik -C doclist 
  1163.   brik -C manlist 
  1164.  
  1165. But we could also do this in a single step by first 
  1166. creating a file called "biglist" that contains the names 
  1167. of these four files: 
  1168.  
  1169.   exelist 
  1170.   comlist 
  1171.   doclist 
  1172.   manlist 
  1173.  
  1174. and then use -Cf thus: 
  1175.  
  1176.   brik -Cf biglist 
  1177.  
  1178. This causes brik to read filenames from "biglist", look 
  1179. inside each of those files ("exelist", "comlist", 
  1180. "doclist", and "manlist") and check the CRCs found there. 
  1181. A UNIX example to do the same thing in a more compact way 
  1182. might be: 
  1183.  
  1184.   cat exelist comlist doclist manlist | brik -Cf - 
  1185.  
  1186.  
  1187. SILENT VERSUS VERBOSE 
  1188.  
  1189. Brik accepts options -s and -v that cause it to be more 
  1190. silent or more verbose than usual. 
  1191.  
  1192. Normally brik prints a message only if it detects an 
  1193. error. For example, if you give the command "brik -c *.c 
  1194. *.h" and brik finds that all Checksum: headers contain 
  1195. CRCs that match the calculated value, it prints nothing. 
  1196.  
  1197. The -v switch makes brik print a message for each file 
  1198. tested that contains the word "ok" if stored and 
  1199. calculated CRCs matched and "BAD" if they did not. 
  1200.  
  1201. In all messages reporting file CRCs, brik prints the 
  1202. actual CRC it calculated, or a row of question marks if 
  1203. it could not calculate one. Brik fails to calculate a 
  1204. CRC if it is trying to calculate a header-based CRC 
  1205. (commands -c and -g) but does not find a Checksum: header 
  1206. in a file. 
  1207.  
  1208. The -s switch tells brik to be silent. This will cause 
  1209. nothing to be printed if brik does not find a Checksum 
  1210. header or if CRCs don't match. However, the status code 
  1211. on exit is still set. The -s option is useful for 
  1212. invoking brik from within a shell script (UNIX) or a 
  1213. batch file (MS-DOS) and later testing the error code it 
  1214. returned when it exited. 
  1215.  
  1216. The -s switch does not suppress the error message printed 
  1217. if brik is given a filename and the file cannot be found. 
  1218. For example, if the command "brik -cs myfile" is given 
  1219. but "myfile" does not exist, brik will print an error 
  1220. message even though the -s option was given. 
  1221.  
  1222.  
  1223. PROGRAM LIMITATIONS 
  1224.  
  1225. Brik 1.0 is designed to work with computer systems that 
  1226. use the 7-bit ASCII character set and 8-bit bytes with 
  1227. the eighth (parity) bit set to zero. 
  1228.  
  1229. Brik 1.0 has not been tested with computer systems that 
  1230. use ASCII characters with the eighth bit set or those 
  1231. that use EBCDIC characters. Although it will calculate a 
  1232. CRC on such machines, the probability of this CRC being 
  1233. the same as the one calculated on machines that use 7-bit 
  1234. ASCII is approximately 0.00000000023. 
  1235.  
  1236.                                     -- Rahul Dhesi 
  1237.                                        1989/03/13 
  1238. @@LIST       PC 
  1239. LIST.COM, by Vern Buerg, a file viewer with scroll, 
  1240. search, print, and many other nifty features. 
  1241.  
  1242. Press F1 (when LIST is running) for a complete help 
  1243. screen.  Note: It's shareware.  Please register. 
  1244.  
  1245. Included here solely for those poor souls who don't have 
  1246. 4DOS and its built-in LIST command. 
  1247.  
  1248. -jkh- 
  1249.